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i STRUCDEF == pecLanel ie FILE FOR DATA STRUCTURE DEFINITION 
D ACCESS MACROS USED IN THE VAX DEBUGGER 


‘ 
Version: *v04-000' 


ASRS SSESISSS SEIT ST TTT TT TTT TT Trcic cirri c tiie irre i icici iit iit iii ii iiiii 


'® COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
ie DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
'* ALL RIGHTS RESERVED. 


ie THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPI 
:* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE - ns M 
A 


* 
+ 
® 
® 
2 
é 
* 

; 0 SOFTWARE OR OTH ® 

'* COPIES THEREOF MAY rit. BE PROVIDED OR OTHERWISE MADE AVAILABLE TO * 

:* OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HERE ® 

!t TRANSFERRED. ® 

4 ® 

'* THE INFORMATION THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 

® 
e 
® 
® 
* 
* 
® 
® 


:* AND SHOULD NO 3E CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
tt CORPORATION. 


FOR THE USE OR RELIABILITY OF ITS 


ie DIGITAL ASSUMES NO RESPONSIBILITY 
IS NOT SUPPLIED BY DIGITAL. 


I 
!* SOFTWARE ON EQUIPMENT WHICH 


eee Ree REE AAR EAA AAA AERA EEA EAAA AEA AAA AAA eee 


WRITTEN BY 
Bert Beander August, 1981. 


MODULE FUNCTION: 
This REQUIRE file contains all macros used in on and accessing 
data structures (BLISS BLOCKs) in the VAX Debugger. These symbolic 
names should always be used in BLISS Field-References. 


K 
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DATA STRUCTURE DEFINITION AND ACCESS 


The following macros must be used in defining field names for all data 
structures in the Debugger. These macros supply the position, size, and 
Barer rens tan values when used in FIELD declarations for BLOCK and 
BLOCKVECTOR data structures. The various generic forms (as specified by 
the letters in the names) are as follows: 


A Materialized address 

L Longword 

W Zero-extended word 

8 Zero-extended pyre 

V Zero-extended bit field 
SW Sign-extended word 

$B Sign-extended pyte 

SV sign-extended bit field 


The ‘'A’’ form should be used whenever the field being defined is such 
that only the address of the field may be materialized in a structure 
reference; that is, fetch and store operations on the field are not 
valid. An example of such a field is an ASCII string. 


Each of the ‘'V'' and ‘’SV"’ forms take one or two parameters. The first 
parameter is the bit position within the sengues (or byte) and the 
second is the field size in bits. The secon per yeepe? is optie al 
if omitted, it defaults to 1. Thus V_(5) means bit 5 while V_(5,3) 

means the $-bit field starting at bit 5 and engine at bit 7. Bi 
ple are counted from the low-order (least significant) end of 
ongword, starting at zero. 


the 


The following data structure picture shows the locations of the various 
fields that can be specified. Note how the bit positions are numbered 
along the top of the illustration. 


1058 ESE Sebo ares tS oi doe resesezi0 


$row were ew eee neces ec esc em e+ Se mee er cee. | ee ees ecrwecres ene cere coe eene + 


Sasniabiandantetoen eeceuinienasins Dexpsonsans necbinetn saueuineaien ‘ 
wi wO_ 
Fee ww ww wwe www own} ew eww wee ee ew own foo eeeooeooeoen= $ Seewceooeoooone 4 
: B3_ t B2_ i Bg. t B0_ ' 
teweeoecce eoeeee pe eceeere sec cece $eowowweesonnece tecerercssmeccoe + 
% = 0, 0, 0%, ! Address of a longword 

A0_ = g. 6. ‘ ! Address of byte 

Al = 8, i, ! Address of byte 
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i] 
! END OF STRUCDEF .REQ 


TB) 
A2_ = 16, 0, 0%, ' Address of byte 
ag: = 24, 0: ; x, i address of byte 
a = 0, 32, O08, ' Longword ; 
We = Q, 16, i, ! Word, zero-extended : 
BL = 0, 8, i, : Byte, zero-extended ; 
wO_ = 0, 16, 9 x, ! Word 9 zero-extended 
wil = 16, 16, %, : Word 1 zero-extended : 
B0_ a Pra Sg ' Byte 0 zero-extended ; 
Bi_ = 8, 8, 8 i, ! Byte 1 zero-extended ; 
B2_ = 16, 8 QO, : Byte § zero-extended : 
B3_ = 24, 8 Of, ! Byte 3 zero-extended : 
VC(P,S) = P, SIF ZNULL(S) 2THEN 1 XELSE S 2F1, 0 %, ! Unsigned bit field 
VO_(P,S) =P MIF XZNULL(S) ZTHEN 1 ZELSE S$ XFI, 9 %, ! Bits in BO_ : 
17(P,S) = (P48), RIF RBNULL(S) RTHEN 1 RELSE S RFI, 0%, | Bits in BI1- ; 
ver(P.8) = (P+165, ZIF XNULL(S) XTHEN 1 XELSE § FI, 0%, | Bits in Be” 
V3_(P,S) = (P+#24), ZIF ZNULL(S) ZTHEN 1 ZELSE S ZFI %, ! Bits in B3_ : 
Su_ = 0, 16, 12%, ! Word, sign-extended : 
SB_ .e 9 8. 38. ! Byte, sign-extended : 
swo.  806= (0, 16, 148, ! word 9 sign-extended ; 
Swi_ = 16, 16, 1%, ! Word 1 sign-extended : 
20. = 0. g. 1%, ! Byte 0 sign-extended : 
$B1_ . 8, Bs 7 he ! Byte 1 sign-extended : 
SB2_ = 16, 8 1%, ! Byte ¢ sign-extended : 
SB3_ = 24, 8, 1%, ! Byte 3 sign-extended : 
SV_(P,S)= P, ZIF ZNULL(S) ZTHEN 1 ZELSE S RFI, 1%, ! Signed bit field : 
SVO_(P,S) =P MIF ZNULL(S) XTHEN 1 ZELSE S 2F1, 1%, ! Bits in BO_ 
SV1-(P,S) = (P+8), XIF ZNULL(S) ZTHEN 1 ZELSE S$ XFI. 1%. | Bits in Bl_ : 
Sv2-(P,S) = (P+16), RIF BNULL(S) RTHEN 1 XELSE $ XFI, 1%, | Bits in B2q 
SV3_(P,S) = (P+#24), ZIF ZNULL(S) ZTHEN 1 ZELSE S 2FI, 1%; ! Bits in B3_ : 
i 
i 
i 
! 
i 
i 
i 
' 
i 
' 
' 
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